Configuring Bot Advanced Settings
This section provides guidance on configuring advanced settings for your bot, allowing you to customize its behavior and functionality to better suit your needs.
General Settings
To set up the general details of your bot, navigate to the General section on the bot Details page and configure the parameters outlined below.
Parameter | Description |
---|---|
Name |
The name of your bot. This field is mandatory and is automatically filled in with the name provided during bot creation. |
Description |
Provide a brief description of your bot. |
Enable web socket |
Tick the checkbox to enable communication over the WebSocket Protocol. |
Block file upload |
When enabled, restricts users from uploading files within chats. In DRUID 7.6 and higher, any attempt by users to upload files will be blocked, and they will receive a notification indicating that file uploads are not supported in that particular chat. You can customize this message easily on the Bot details page under Dialogue management > Special messages. |
Is out of band upload |
By default, users can upload files of maximum 4 MB in the chat. Important! For exceptional situations only, select this option to allow users to upload files of up to 30 MB in the chat, instead of the default limit of 4 MB.
|
Bot Framework Version |
Choose between version 3 and version 4 of the Bot Framework. Version 4 offers enhanced customization options and features such as adaptive cards in conversational flows. |
AllowedOrigins |
Specify the domains from which your bot can be accessed to restrict access to authorized domains only. Note: You need to specify the allowed origin in the following format: https://domain.tld; otherwise, it will not take effect. For example: https://druidai.com.
Hint: You can specify multiple allowed origins separated by comma.
|
BotId |
Bot unique identifier. The system automatically fills in this field. |
SourceId |
Unique identifier used for elements identification during an import-export process. The system automatically fills in this field. |
Special Flows & Predefined Responses
The Bot Designer allows you to define specific responses triggered by special events during a conversation. You can edit predefined responses or set flows to be automatically triggered when certain events occur. To configure special flows and predefined responses:
- Navigate to the Dialogue Management section on the bot Details page.
- Scroll down to the Keys table listing predefined responses.
- Provide the default and localized keys for additional languages for each response.
For more information about special flows, see Special Flows.
Adding and customizing special messages
The DRUID special messages nomenclature comprises two types of messages:
- Default system messages: These messages are automatically included in all bots by default.
- New special messages: These messages are not automatically propagated to all bots. New special messages are highlighted in orange for easy identification. It's important to note that the DRUID Flow Engine does not utilize these messages during conversation time.
DRUID special messages are customizable per bot to suit your specific requirements.
To add specific special messages to your bot, click on the Add message to bot icon associated with the desired message(s).
To delete a specific special message from the bot, click the Remove from bot special messages icon () in front of that message.
The table below lists all customizable special messages and describes when each message is sent.
Special Message |
Description |
---|---|
AdaptiveCardNotSubmitted |
This message notifies the user that they need to submit their response using the options provided in the adaptive card. It is triggered when the user types something else in the chat without completing the required fields in the adaptive card. |
CancelReplyMessage |
This message is sent by the bot when the user types "cancel" in the chat, acknowledging the cancellation request and confirming that the current process or action has been stopped. |
CantDiscloseInformation |
This message alerts the user that they do not have permission to access the matched intent, as their role is not among the flow's roles. |
CantInvokeAlertFlow |
Error informing that the alert flow cannot be triggered, due to technical reasons. |
ChooseVariant |
Appears when the flow reaches a step requiring the user to choose from provided options (e.g., choice, hero cards) and intent switching is disabled. If the user enters input that doesn't match any of the available options, this message will be displayed until a valid choice is made. |
DoNotSeeMore |
|
DoSeeMore |
|
DoYouWantToSeeMore |
|
FileUploadedInIdle |
This message is displayed when a user attempts to upload a file while the conversation is in Idle mode. It informs the user that file uploads are only allowed when actively requested, ensuring a smoother interaction and providing clear feedback. |
InactivityCancelConversation |
This message is displayed when a conversation is automatically canceled due to user inactivity. If no specific flow is configured for handling inactivity (Inactivity Cancel Conversation Flow), the chatbot responds with this message before ending the conversation. If the inactivity threshold is reached while an inactivity flow is running, this message is also sent before the conversation is dropped. |
InactivityWarningMessage |
This message is sent as a warning to the user when they have been inactive for half of the set inactivity threshold (Flow Timeout (min)). It appears while the user is on a flow step that requires input mapping, prompting them to respond before the conversation is automatically canceled. |
InputValueInterpretationError |
This message is displayed when the Flow Engine extracts at least one entity field from the user input but not the specific entity field defined in the input mapping of the flow step. In this case, the chatbot does not proceed and instead prompts the user to clarify their response, ensuring the required entity field is captured correctly. |
InsertDateAlso |
This is the default message sent to the user during input mapping for a DateTime field when the user's input (response) only includes the time, and the date component is missing. |
InsertHourAlso |
This is the default message sent to the user during input mapping for a DateTime field when the user's input (response) only includes the date, and the time component is missing. |
LoadingExistingConversation |
|
NoBotAccess |
The default message sent to the user when their when the conversation user roles don’t match any corresponding roles configured on the bot. |
NoIntentIdentified |
Default fallback message used when the bot doesn’t recognize the user’s intent and no specific “Intent not recognized” flow is configured. |
NoPermissionsForTargetIntent |
|
NothingImplemented |
|
OAuthLink |
When a user attempts to access restricted features, this message delivers a secure authentication link directly within the chat. Following this link allows the user to verify their identity and gain the necessary authorization. |
ReleaseErrorMessage |
This message is sent to the user in the chat when an error occurs during the conversation, notifying them of the issue and prompting further action if needed. |
ResetReplyMessage |
This message is sent by the bot when the user types "reset" in the chat, confirming that the conversation reset request has been acknowledged. |
SensitiveDataInputWarning |
This message is displayed during Prompt steps that involve sensitive data handling. |
SwearingObjection |
Deprecated |
UploadFileBlocked |
This message is displayed when a user tries to upload a file on a bot that has the "Block file upload" setting enabled in the General section. The bot will prevent file uploads, ensuring that no files can be shared through the chat. |
UploadFileFailed |
This message is displayed when a user attempts to upload a file that does not meet the defined file restrictions. This can occur if the file type is not supported or if the file exceeds the maximum allowed size. When a file upload fails validation, DRUID raises an exception that can be handled in the flow to guide the user accordingly. For more information, see File Upload. |
WaitForConnectorActionComplete |
This message is displayed when a user sends a message while a delay is in progress on a flow step. The delay, set between 1 and 10 seconds, occurs between the pre-action and the step message. If the user interacts with the bot during this waiting period, the bot responds with this special message to inform them that it is still processing their request. |
Analytics
You can set the currency metric name for Dashboard FTEs. From the Currency drop-down, select the desired currency. If no currency is selected, DRUID uses the default value, EUR.